home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc A) / Acorn User China CD-ROM (UK) (Disc A).bin / HENSA / FILEVIEW / QUICK_RAYTRACE.ARC / Documents_!ReadMe < prev    next >
Encoding:
Text File  |  1990-01-09  |  3.8 KB  |  91 lines
  1. !QRT - the Quick Ray Tracer
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Main ray tracer code & documentation copyright 1988, 1989 Steve Koren.
  5.  
  6. Archimedes port & documentation copyright 1989, 1990 Philip Colmer.
  7.  
  8. This file documents version 1.5c of !QRT.
  9.  
  10. ----------------------------------------------------------------------------
  11.  
  12.    QRT is a public domain ray tracer written in C by Steve Koren. It has
  13. been ported on to the Archimedes and adapted for the RISC OS environment by
  14. Philip Colmer. This file documents differences between the Archimedes
  15. version and the version detailed in the remaining documentation.
  16.  
  17.    Other documentation:
  18.  
  19. CFG            Context free grammar rules for QRT
  20. Discuss        Discussions of some QRT feastures
  21. Errors         Explanation of errors raised by QRT
  22. Intro          An introduction to QRT
  23. Language       A definition of QRT's language
  24. ReadMe_1       Steve Koren's copyright notice
  25. UserMan        The user manual for QRT
  26.  
  27.    When QRT is started, it produces a window on the desktop. There are three
  28. output options:
  29.  
  30. RAW file:   If this option is ticked, QRT will create a file containing:
  31.             2 bytes: x resolution
  32.             2 bytes: y resolution
  33.             then for each line, x bytes of red, x bytes of green and x bytes
  34.             of blue.
  35.             The main reason for having this option is to allow the
  36.             Archimedes to be used to perform the ray tracing and then create
  37.             the image for some other computer.
  38.  
  39. IMG file:   If this option is ticked, QRT will create a sprite file
  40.             containing one sprite, namely the image. This is the more usual
  41.             option.
  42.  
  43. Stats file: If this option is ticked, QRT will create a statistics file
  44.             containing information like the number of objects and number of
  45.             rays.
  46.  
  47.    There is one ray-tracing option:
  48.  
  49. No shadows: If this option is ticked, no shadows will be built when the
  50.             object is ray-traced.
  51.  
  52.    Any 256-colour mode can be set to create the image in. The main impact on
  53. this, and the four size options, is the final image size. Recommended screen
  54. modes are 13, 15 and 21. Both the screen mode and the image size selection
  55. are saved in QRT's setup file for later use. After changing the screen mode,
  56. press RETURN.
  57.  
  58.    To ray-trace an image, drop the DIRECTORY containing the QRT file on to
  59. the QRT window. The START icon will then become visible. If you are happy
  60. with the settings, click on the START icon. If you want to suspend or abort
  61. ray-tracing, click on the appropriate icon. Suspending ray-tracing allows
  62. you to examine the RAW or IMG file so far so that you can check the
  63. progress.
  64.  
  65.    If the final image looks too tall or too wide, it is possible to change
  66. the aspect ratio of the image. To do this, position the pointer over the QRT
  67. window and click MENU. Slide to the right of the Aspect ratio option and
  68. enter the required value. This value will be kept in QRT's setup file.
  69.  
  70. Changes from the original QRT
  71. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  72. 1. Since QRT is an application, there are no command line options. Any
  73. mention of this in the documentation should be ignored.
  74.  
  75. 2. QRT supports the FILENAME keyword, but it is ignored. Any output files
  76. are always placed in the directory dropped on to QRT.
  77.  
  78. 3. Some of the documentation will mention increasing the stack size. !QRT
  79. takes memory as it is required. It should be noted that the larger the
  80. resulting image size and the more complex the QRT file, the more memory is
  81. required. If the application runs out of memory, remove any unnecessary
  82. tasks. If the application runs out of stack, it will need a bigger initial
  83. slotsize.
  84.  
  85. Known bugs
  86. ~~~~~~~~~~
  87. 1. If you have perfect reflective surfaces, the rays can bounce around ad
  88. infinitum, resulting in QRT running out of stack and disappearing off the
  89. desktop, leaving the hourglass on. The solution is to reduce the
  90. reflectivity from 1 to 0.9
  91.